home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / setpup.z / setpup
Encoding:
Text File  |  2002-10-03  |  3.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. sssseeeettttppppuuuupppp((((3333GGGG))))                                                          sssseeeettttppppuuuupppp((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sssseeeettttppppuuuupppp - sets the display characteristics of a given pop up menu entry
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd sssseeeettttppppuuuupppp((((ppppuuuupppp,,,, eeeennnnttttrrrryyyy,,,, mmmmooooddddeeee))))
  13.      lllloooonnnngggg ppppuuuupppp,,,, eeeennnnttttrrrryyyy;;;;
  14.      uuuunnnnssssiiiiggggnnnneeeedddd lllloooonnnngggg mmmmooooddddeeee;;;;
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _p_u_p     expects the menu identifier of the menu whose entries you want to
  18.              change. The menu identifier is the returned function value of the
  19.              menu creation call to either nnnneeeewwwwppppuuuupppp or ddddeeeeffffppppuuuupppp.
  20.  
  21.      _e_n_t_r_y   expects the position of the entry in the menu, indexed from 1.
  22.  
  23.      _m_o_d_e    expects a symbolic constant that indicates the display
  24.              characteristics you want to apply to the chosen entry.  You can
  25.              specify more than one at a time by adding or logically or-ing
  26.              these values together.  For this parameter there are four defined
  27.              symbolic constants:
  28.  
  29.              PPPPUUUUPPPP____NNNNOOOONNNNEEEE, no special display characteristics, fully functional if
  30.              selected.  This is the default mode for newly created menu
  31.              entries.
  32.  
  33.              PPPPUUUUPPPP____GGGGRRRREEEEYYYY, entry is greyed-out and disabled.  Selecting a greyed-
  34.              out entry has the same behavior as selecting the title bar.  If
  35.              the greyed-out entry has a submenu associated with it, that
  36.              submenu does not display.
  37.  
  38.              PPPPUUUUPPPP____BBBBOOOOXXXX Entry has an empty box to the left.
  39.  
  40.              PPPPUUUUPPPP____CCCCHHHHEEEECCCCKKKK Entry has a checked box to the left.
  41.  
  42. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  43.      Use sssseeeettttppppuuuupppp to alter the display characteristics of a pop up menu entry.
  44.      Currently, you use this routine to disable and grey-out a menu entry.
  45.  
  46. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  47.      Here is an example that disables a single entry:
  48.  
  49.      menu = newpup();
  50.      addtopup(menu,"menu %t |item 1 |item 2 |item 3 |item 4",0);
  51.      setpup(menu, 1, PUP_GREY);
  52.  
  53.  
  54.      Subsequent calls of ddddooooppppuuuupppp((((mmmmeeeennnnuuuu)))) would display the menu with the menu
  55.      entry labeled ``item 1'' is greyed out, and never gets a return value of
  56.      1.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. sssseeeettttppppuuuupppp((((3333GGGG))))                                                          sssseeeettttppppuuuupppp((((3333GGGG))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      defpup, dopup, freepup, newpup
  76.  
  77. NNNNOOOOTTTTEEEE
  78.      This routine is available only in immediate mode.
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.